home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / altrn234.zip / WHATSNEW.234 < prev   
Text File  |  1990-06-22  |  9KB  |  264 lines
  1.                 What's New in ALTERN version 2.34
  2.  
  3.  
  4. A. QNS.DAT
  5. B. USING QNS.DAT
  6. C. BATCH PROCESSING
  7. D. ALTERN AS A DTP PREPROCESSOR
  8. E. HISTORY since version 2.2
  9.  
  10. A.     Recent revisions of Altern have been mainly concerned first to 
  11. avoid the need for typing in each set of strings containing double 
  12. quotation marks (") every time that the program is run, and second 
  13. to allow automatic processing, with if necessary several runs of 
  14. the program, from a batch file.
  15.  
  16.      In the documentation for version 2.2 it was wrongly stated 
  17. (page 4, section 6, end of page) that console input could be 
  18. rerouted by using Dos redirection. Owing to a still-uncorrected 
  19. bug in MS-DOS that does not work with any version of DOS up to and 
  20. including 3.3. It has not been tested with later versions.
  21.  
  22.      To get round the problem ALTERN version 2.3 allowed the 
  23. preparation of a keystacking file called QNS.DAT. That is a text 
  24. file which feeds answers to the prompts exactly as they would be 
  25. typed from the keyboard. The QNS.DAT file must normally be in the 
  26. current directory (it may be sufficient merely to ensure that it 
  27. is in the current data path, but that has not been tested). If 
  28. ALTERN cannot find QNS.DAT, the prompts must be answered by typing 
  29. the replies at the keyboard, as in version 2.2.
  30.  
  31.  
  32.  
  33. B.                         USING QNS.DAT
  34.  
  35.  
  36.      It is easiest to understand the QNS.DAT procedure by trying 
  37. it. First set up your file-list file and string-list files. Then 
  38. run ALTERN without a QNS.DAT file present, entering your responses 
  39. at the keyboard. Each time you type an answer, make a note on 
  40. paper of what you typed. Each response will form a single line, 
  41. terminated by a carriage return/line feed sequence, in the QNS.DAT 
  42. file. Remember to allow a blank line for every response where the 
  43. prompt simply asks you to press Enter to continue.
  44.  
  45.      Then you can use your ASCII text editor to type the QNS.DAT 
  46. file from your notes, with each response on a single line; press 
  47. Return for a blank line. Then try running the program again.
  48.  
  49.  
  50.                     EXAMPLE OF A QNS.DAT FILE
  51.  
  52.      The following is a QNS.DAT file which has been used 
  53. regularly. It is listed twice, first 'as is' and secondly with 
  54. comments (which should NOT be included in a real QNS.DAT file). 
  55. The file begins on the line after the hyphens.
  56. ---------------------------------------------------------------
  57.  
  58. TEXTLIST
  59. ALTEXT.LST
  60. GLOBTEXT.LST
  61. Y
  62. N
  63. Y
  64. 2
  65.  "
  66.  <OD>
  67. ",
  68. <ZZ>,
  69.  
  70. ---------------------------------------------------------------
  71.                                   [blank line at prompt] 
  72. TEXTLIST                          [name of filelist file]
  73. ALTEXT.LST                [name of alternate replacement list]
  74. GLOBTEXT.LST              [name of global replacement list]
  75. Y                         [Yes-check for Wordstar 8th bits]
  76. N                    [No - no 'manual' alternate replacements]
  77. Y                    [Yes - I want to enter global replacements]
  78. 2                [Number of global replacements to be entered]
  79.  "               [String to be replaced - space-double quote]
  80.  <OD>            [replacement string]
  81. ",               [string to be replaced - double quote-comma]
  82. <ZZ>,            [replacement]
  83.                  [blank line]
  84. ------------------------------------------------------------------
  85.  
  86.  
  87.  
  88. C.                       BATCH PROCESSING
  89.  
  90. With ingenious use of batch files the number and complexity of 
  91. files that can be processed and strings that can be replaced using 
  92. Altern is almost unlimited.
  93.  
  94. 1. Running ALTERN on several sets of files each with a different 
  95. set of replacements
  96.  
  97.      The following example shows a batch file used for preparing 
  98. large sets of text and endnote files for typesetting. Two files 
  99. called TEXTQNS.DAT and NOTEQNS.DAT contain the respective 
  100. filelists, lists of replacements, and 'manual' entries. The batch 
  101. file renames each one QNS.DAT, runs the program, and re-renames 
  102. the QNS.DAT file. (You could use COPY instead of REN to avoid the 
  103. need for re-renaming). Rerouting console output to the printer 
  104. ensures that if an error occurs when the computer is unattended it 
  105. will be recorded.
  106.  
  107.  
  108. REN TEXTQNS.DAT QNS.DAT
  109. PAUSE switch the printer on
  110. ALTRN234 >prn:
  111. REN QNS.DAT TEXTQNS.DAT
  112. REN NOTEQNS.DAT QNS.DAT
  113. ALTRN234 >prn:
  114. REN QNS.DAT NOTEQNS.DAT
  115.  
  116. 2. Running ALTERN on a single set of files with over 64 global 
  117. replacements to be done in each file
  118.  
  119. The following examples show two alternative ways of handling 512 
  120. global replacements. Altern is run eight times from a single 
  121. commmand. The files to be processed all have the extension .TXT. 
  122. The .COD files are renamed at each pass so that each stage is 
  123. recorded. The first method [a):] is (as before) to set up eight 
  124. QNS.DAT files under different names, and rename them at each pass. 
  125. The second method [b):] uses a single QNS.DAT file in which the 
  126. list of global replacements is called GLOBLIST. Each 64-string 
  127. replacement file, called LISTx.DAT, is renamed GLOBLIST for the 
  128. pass in which it is used. The list of alternate replacements is a 
  129. dummy, so remains unchanged, as does the list of files to be 
  130. processed.
  131.  
  132. a):
  133. REN QNS1.DAT QNS.DAT
  134. ALTRN234
  135. REN *.TXT *.BK1
  136. REN *.COD *.TXT
  137. REN QNS.DAT QNS1.DAT
  138. REN QNS2.DAT QNS.DAT
  139. ALTRN234
  140. REN *.TXT *.BK2
  141. REN *.COD *.TXT
  142. REN QNS.DAT QNS2.DAT
  143. REN QNS3.DAT QNS.DAT
  144. ALTRN234
  145. REN *.TXT *.BK3
  146. REN *.COD *.TXT
  147. REN QNS.DAT QNS3.DAT
  148. REN QNS4.DAT QNS.DAT
  149. ALTRN234
  150. REN *.TXT *.BK4
  151. REN *.COD *.TXT
  152. REN QNS.DAT QNS4.DAT
  153. REN QNS5.DAT QNS.DAT
  154. ALTRN234
  155. REN *.TXT *.BK5
  156. REN *.COD *.TXT
  157. REN QNS.DAT QNS5.DAT
  158. REN QNS6.DAT QNS.DAT
  159. ALTRN234
  160. REN *.TXT *.BK6
  161. REN *.COD *.TXT
  162. REN QNS.DAT QNS6.DAT
  163. REN QNS7.DAT QNS.DAT
  164. ALTRN234
  165. REN *.TXT *.BK7
  166. REN *.COD *.TXT
  167. REN QNS.DAT QNS7.DAT
  168. REN QNS8.DAT QNS.DAT
  169. ALTRN234
  170. REN *.TXT *.BK8
  171. REN *.COD *.TXT
  172. REN QNS.DAT QNS8.DAT
  173.  
  174.  
  175. b):
  176.  
  177. REN LIST1.DAT GLOBLIST
  178. ALTRN234
  179. REN *.TXT *.BK1
  180. REN *.COD *.TXT
  181. REN GLOBLIST LIST1.DAT
  182. REN LIST2.DAT GLOBLIST
  183. ALTRN234
  184. REN *.TXT *.BK2
  185. REN *.COD *.TXT
  186. REN GLOBLIST LIST2.DAT
  187. REN LIST3.DAT GLOBLIST
  188. ALTRN234
  189. REN *.TXT *.BK3
  190. REN *.COD *.TXT
  191. REN GLOBLIST LIST3.DAT
  192. REN LIST4.DAT GLOBLIST
  193. ALTRN234
  194. REN *.TXT *.BK4
  195. REN *.COD *.TXT
  196. REN GLOBLIST LIST4.DAT
  197. REN LIST5.DAT GLOBLIST
  198. ALTRN234
  199. REN *.TXT *.BK5
  200. REN *.COD *.TXT
  201. REN GLOBLIST LIST5.DAT
  202. REN LIST6.DAT GLOBLIST
  203. ALTRN234
  204. REN *.TXT *.BK6
  205. REN *.COD *.TXT
  206. REN GLOBLIST LIST6.DAT
  207. REN LIST7.DAT GLOBLIST
  208. ALTRN234
  209. REN *.TXT *.BK7
  210. REN *.COD *.TXT
  211. REN GLOBLIST LIST7.DAT
  212. REN LIST8.DAT GLOBLIST
  213. ALTRN234
  214. REN *.TXT *.BK8
  215. REN *.COD *.TXT
  216. REN GLOBLIST LIST8.DAT
  217.  
  218.  
  219.  
  220. D.                   ALTERN AS A DTP PREPROCESSOR
  221.  
  222.  
  223.      Although revisions of Altern since 1988 have concentrated on 
  224. making it more useful for generic-coded typesetting applications, 
  225. it has recently begun to shine as a tool for use with Xerox (R) Ventura 
  226. Publisher (TM, R, anathema sit etc.). Whether it will be equally 
  227. useful with other DTP programs, or SGML jobs, depends on how they 
  228. work; I have not tested them.
  229.  
  230.      When a text file (either ASCII or from an appropriate word 
  231. processor) is edited in a Ventura chapter, Ventura automatically 
  232. modifies the file to include its own typesetter codes. Once you 
  233. have identified the codes used in the first chapter of your 
  234. application by re-examining the word-processor file or files after 
  235. leaving Ventura, you will find that it is much quicker to type 
  236. them with the word processor into the text files for the remaining 
  237. chapters BEFORE using Ventura. In many cases the codes replace 
  238. word-processor codes or toggles, or particular character strings 
  239. (e.g. ligatures); such codes can be much more easily and 
  240. consistently replaced throughout a large amount of text by using 
  241. ALTERN.
  242.  
  243. E.                  HISTORY since version 2.2
  244.  
  245. Feb. 1989: Version 2.3: QNS.DAT. Not released
  246.  
  247.  
  248. Apr.-May 1989: Versions 2.31 -2.33: minor revisions: not released
  249.  
  250. June 1989: Version 2.34 attempts to fix a bug in earlier versions. 
  251. In some cases if non-standard paragraph-end codes were specified 
  252. in the PA